home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 2 / AACD 2.iso / AACD / Graphics / ImageFX / LoadGifAnim / LoadGifAnim.Doc < prev    next >
Encoding:
Text File  |  1999-02-24  |  4.2 KB  |  93 lines
  1. LoadGifAnim.Ifx
  2. $ver:   1.00, 17 Feb 1999
  3. by Bryan K. Williams, <icar@evilgeniuses.org>
  4. © CrystalWorks, Freely Distributable
  5. <http://www.evilgeniuses.org/>
  6.  
  7. Send bug reports to <GifBug@evilgeniuses.org>
  8. Find the latest version at 
  9.    <http://www.evilgenius.org/crystalworks/Amiga/>
  10.  
  11. What is it?
  12. -----
  13.    This is an ImageFx script that will allow loading of the individual
  14. frames of an animated gif.  With it, you can either bust the anim into
  15. it's individual frames, or load a single image out of the sequence.
  16.  
  17. Where do you put it?
  18. -----
  19.    It can be placed in your ImageFX:rexx drawer for ease of use, or
  20. anywhere else you might like, as long as you remember where you put it :-)
  21.  
  22. Quick History:
  23. -----
  24.    About a year ago (1998), I created an Arexx script that would split a
  25. gif anim into individual images.  It worked well, as long as the gif used
  26. a full frame for each image.  It was less useful with gifs that would only
  27. save the differences (or delta) from each frame.  I finally found time to
  28. go back to that script, and make a better version using ImageFX to process
  29. the delta frames.  This is the result.
  30.  
  31. How does it work?
  32. -----
  33.    No LZW compression code required!
  34.  
  35.    Instead of trying to decode each image and figure out the differences
  36. in Arexx, this script instead cuts & pastes the important parts of each
  37. frame to create a complete gif.  It then tells ImageFX to load this new
  38. gif, and if necessary, place it in the correct place on the image.
  39.  
  40. No, no, how do I load a gif with it?
  41. -----
  42.    From ImageFX, click the AREXX button, and select this script.  Be
  43. warned that running the script will destroy any current buffer, and
  44. possibly (depending upon the gif) any swap buffer and brush that you may
  45. have loaded (it will warn you of this).  It will then ask you to select a
  46. gif.  After selecting a gif, it will ask you if you want to BUST this anim
  47. or not.  Busting the anim will separate the gif into individual frames,
  48. saved in the drawer you select.  The frames will be saved as 24-bit
  49. ILBM's.  After the anim is busted, you will be left with the final frame
  50. in the buffer.
  51.  
  52.    If you select not to bust the anim, you will be given a slider which
  53. will ask you which frame you wish to load.  Select the frame and click ok.
  54. After the script is done, you will be left with the frame you selected in
  55. the buffer.
  56.  
  57. What does it mean, "Do you want to load QUICK?"
  58. -----
  59.    In certain situations, the anim may be composed of full frames, yet
  60. have a transparent color.  When this happens, the script gives you the
  61. option to try to load the requested frame directly without going through
  62. the intermediate frames.  In most situations, this works fine.  Saying yes
  63. at this point will cut the load time tremendously.  But it may not work. 
  64. By the time the script is done,n you'll be able to instantly see if it
  65. worked or not, because a failure will look nothing like the original anim.
  66.  
  67. Long, Boring, History
  68. -----
  69.  
  70. 1.0, 17 Feb 1999:  Fixed stupid error on anims that had a Local Color Map
  71.    and transparency.  This was the only anim situation I was unable to test
  72.    because I couldn't find a gif that did this.  The result was corrupt gifs
  73.    that would cause IFX to guru.
  74. 0.99, 15 Feb 1999: Added support for anims that do not supply a complete
  75.    background in the first frame. I think I've covered most, if not all,
  76.    gif anim possibilities.  I know someone will prove me wrong on this :-)
  77.    First Public release.
  78. 0.15, 14 Feb 1999: Noticed bug in handling of local color tables and 
  79.    transparency.  Should work now, but I'm unable to find a gif to test it.
  80.    Added some user friendliness :^)
  81. 0.12, 10 Feb 1999: A partial rewrite in order implement Anim Busting.  Also
  82.    to better handle some gifs.
  83. 0.10, 05 Feb 1999: Now properly handles gifs with a Disposal method of 2 (Restore
  84.    to background color).  Not done in the best way, but it works
  85. 0.9, 01 Feb 1999: Properly handles gifs with a transparent color that's duplicated
  86.    within the normal palette (i.e. has a black color, but also uses a second, equal
  87.    black for the transparent color)
  88. 0.8, 31 Jan 1999: Added ability to work with some (most?) delta frame gif anims.
  89.    Still needs to check the GCL's Disposal Method for frames to decide what to do
  90.    with them.
  91. 0.7, 26 Jan 1999: Working with full frame images
  92.  
  93.